home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 028a / autosn33.zip / AUTOSCAN.DOC < prev    next >
Text File  |  1991-11-07  |  16KB  |  353 lines
  1.  
  2.                ╓──╖
  3.                ║  ║
  4.                ║  ║  ╥   ╥ ╓─╥─╖ ╓───╖ ╓───  ╓───╖  ╓──╖  ╥┐   ╥
  5.               ╓╨──╨╖ ║   ║   ║   ║   ║ ║     ║      ║  ║  ║└┐  ║
  6.               ║    ║ ║   ║   ║   ║   ║ ╙───╖ ║     ╓╨──╨╖ ║ └┐ ║
  7.               ║    ║ ║   ║   ║   ║   ║     ║ ║     ║    ║ ║  └┐║
  8.               ╨    ╨ ╨───╨   ╨   ╙───╜ ────╜ ╙───╜ ╨    ╨ ╨   └╨
  9.                      v   e   r   s   i   o   n     3  .  3
  10.                 Copyright (C) 1991, /\/\ountainTop Technologies
  11.                   All Rights Reserved. Written by Nick Tucker.
  12.  
  13.  
  14.  Why the need for such a complicated algorithm?
  15.  ──────────────────────────────────────────────
  16.  There was a need for a quick and easy way checking files for viruses
  17.  on BBS systems (Recent Uploads can always be a hazard, especially when
  18.  left unattended). There are many "shells" that are available, but they
  19.  are either too slow or don't work correctly. AUTOSCAN was written to 
  20.  work with the McAffee SCAN program and various archiving programs.
  21.  
  22.  Required Files
  23.  ──────────────
  24.  PKUNZIP.EXE
  25.  PAK.EXE
  26.  PKUNPAK.EXE (or PKXARC.EXE and/or XARC.EXE)
  27.  LHA.EXE or LHARC.EXE or ICE.EXE
  28.  ARJ.EXE
  29.  SCAN.EXE
  30.  
  31.  How does it work?
  32.  ─────────────────
  33.  The way it works is very simple, all it does is un-archive any ZIP, ARC,
  34.  ICE, LZH, PAK, or ARJ file into a work directory (\AUTOSN), then
  35.  use McAffee's SCAN.EXE to scan it for any virus (Since SCAN is updated
  36.  regularly, you don't have to worry about AutoScan becoming outdated or
  37.  missing any recent viruses.) If all goes well and no viruses are found,
  38.  it deletes all the "work" files and then moves onto the next file and
  39.  repeats the process.
  40.  
  41.  To get going is real simple, copy AUTOSCAN.EXE into a directory in your
  42.  path ( example in AUTOEXEC.BAT:
  43.  
  44.  PATH = C:\;C:\UTIL;
  45.  
  46.  when AUTOSCAN.EXE is in C:\UTIL ).  Change to the directory you wish to
  47.  scan, and type "AUTOSCAN". 
  48.  AutoScan will then look through the Current Directory for ZIP, ARC, 
  49.  ICE, PAK, LZH, ARJ and SDN files, un-archive them and scan them, if all
  50.  goes well it will proceed onto the next file. In order for everything to
  51.  work all the un-archivers should be within reach upon the currect path,
  52.  PKUNPAK.EXE, PKUNZIP.EXE, LHARC.EXE, LHA.EXE, ICE.EXE, PAK.EXE, ARJ.EXE
  53.  and, most importantly, SCAN.EXE.  If any of the un-archivers are not 
  54.  found that section will not execute, you don't need them all to run 
  55.  AUTOSCAN, however if SCAN.EXE is not located the program will halt.
  56.  
  57.  AutoScan will keep a detailed log of it's activities in the same
  58.  directory that contains AUTOSCAN.EXE appropriately named AUTOSCAN.LOG. 
  59.  If it already exists, new information will be appended to it.
  60.  
  61.  "What if?" he said
  62.  ──────────────────
  63.  What if there is an archive within an archive? AutoScan will detect if there
  64.  are any archives within archives - to any level and any combination of
  65.  archive types. If an error is located in a "sub archive" that name is placed
  66.  in the log along with the main archive name and what the error was - Virus
  67.  or bad archive.  
  68.  
  69.  About ARC
  70.  ─────────
  71.  AutoScan supports most major ARC type archivers, PKPAK, PKARC and the SEA
  72.  ARC7, it can tell the difference between the three and will use the 
  73.  appropriate archiver to un-archive the file. If AutoScan detects a file
  74.  generated by the ARC7 archiver and XARC is not available that file will be 
  75.  skipped, however if XARC is found and PkPak or PkArc isn't, AutoScan will 
  76.  attempt to use ARC7 for the Arc type unarchiver.
  77.  
  78.  About PAK
  79.  ─────────
  80.  AutoScan, when examining a PAK archive, will only un-archive the type 10
  81.  compression (Crushed) and the type 11 compression (Distilled).
  82.  
  83.  SETTING THE ENVIRONMENT
  84.  ───────────────────────
  85.  Some DOS versions don't report the drive name when asked to...If you see
  86.  "  ■ FOUND \DOS\PKUNZIP.EXE " (note the missing "C:") and then AutoScan 
  87.  exits on an error then you have this problem.  Starting with this version
  88.  the ability to use an Environmental Variable has been added.  Somewhere in
  89.  your AutoExec.Bat add a line that reads
  90.  " SET AUTOSCAN={drive\path} " to where AutoScan.Exe can be found.  Consult
  91.  your DOS manual on further help with setting the environment.
  92.  
  93.  COMMAND LINE OPTIONS
  94.  ────────────────────
  95.  AUTOSCAN /S
  96.  If you wish to have your Hardrive scanned as well put a /S on the command
  97.  line.  All drives C: through Z: will be scanned if they exist.  The setting
  98.  in AutoScan.Cfg (if it exists) with the /P option will be used with SCAN.EXE
  99.  
  100.  AUTOSCAN /Q 
  101.  When AutoScan finishes it sounds a two tone bell a few times, or in the
  102.  case of a VIRUS, many times! If you wish to run it in the QUIET MODE put
  103.  a /Q on the command line.
  104.  
  105.  AUTOSCAN /C 
  106.  This will trick AutoScan into thinking that there is a virus, and will do
  107.  the following:
  108.  1. Rename the archive to .BAD
  109.  2. Exit at an errorlevel of 1
  110.  3. Beep it's ass off if you're unregistered or not working in "Quiet" mode
  111.  You must have an archive in the current directory (ALONG WITH CHECK.EXE)
  112.  to use this.  You may use no other command line options.
  113.  
  114.  AUTOSCAN /R
  115.  AutoScan will rescan all files archives. This option is as if you had 
  116.  deleted AutoScan.Dat, which is exactly what AutoScan does.
  117.  
  118.  AUTOSCAN /M
  119.  AutoScan will instruct Scan.exe not to scan RAM at all. Without this option
  120.  RAM will be scanned only on the first pass or if a virus was found RAM will
  121.  be scanned again.
  122.  
  123.  AUTOSCAN /O
  124.  To scan a single file. This will not enter the name into AUTOSCAN.DAT, or
  125.  even check to see if it has been processed before. Just a quick and dirty
  126.  scan. IE: AUTOSCAN /OTEST.ZIP 
  127.  A path and file name can be specified, sorry no wildcards.
  128.  
  129.  AUTOSCAN /F
  130.  This will instruct AutoScan to reboot the machine once all operations have
  131.  been completed, a five (5) second count down can be aborted by pressing any
  132.  key. This feature is usefull if you are doing an entire drive scan and don't
  133.  want to sit around watching it run, when it's done it will reboot and bring 
  134.  up your BBS or Menu system if you have one. 
  135.  
  136.  AUTOSCAN /U
  137.  This will instruct AutoScan to uses a specific drive to unarchive files
  138.  to.  /UC will cause AutoScan to create the work directory \AUTOSN on the
  139.  C drive ( C:\AUTOSN ) reguardless of what drive AutoScan is on.  
  140.  The use of a RAMDISK will greatly increase the speed of AutoScan, however
  141.  be aware of the size of the RamDisk and the size of the archive you wish
  142.  to scan! 
  143.  
  144.  AUTOSCAN /N  * - Registered Version.
  145.  This will instruct AutoScan to check for Bad Archives ONLY, only use this
  146.  option if you are sure the file is free of Virus's. 
  147.  
  148.  AUTOSCAN /A  * - Registered Version.
  149.  AUTOSCAN will search the ENTIRE DRIVE for archives and scan them. AUTOSCAN
  150.  will not update the AUTOSCAN.DAT or check to see if the file has been
  151.  processed. IE: AUTOSCAN /AC: If no drive is specified the default is used.
  152.  
  153.  AUTOSCAN /T  * - Registered Version.
  154.  This will instruct AutoScan to check the size, time and date of the archive.
  155.  If it has changed, the archive will be rescanned. If you run AutoScan from a
  156.  BBS to check any recent uploads you might not want to use this option. If you
  157.  add ZIP comments to a file, it will obviously change the file size and cause
  158.  AutoScan to rescan it.
  159.  
  160.  AUTOSCAN /D  * - Registered Version.
  161.  With this option you can specify the directory to scan on the command line.
  162.  IE: AutoScan /DF:\WORK . Any files in the F:\WORK directory will be scanned.
  163.  
  164.  AUTOSCAN /I  * - Registered Version.
  165.  All this does is supress the blue or red box upon completion, the same info
  166.  is written to the screen in a "normal manner".
  167.  
  168.  AUTOSCAN /B  * - Registered Version.
  169.  To direct AutoScan to place any .BAD files in a specified directory.
  170.  IE: AUTOSCAN /BC:\BADFILES  where C:\BADFILES is the directory.
  171.  
  172.  All command line options must be seperated by a space and they may be in 
  173.  any order you wish. 
  174.             AUTOSCAN /Q /R /BC:\BADFILES /I /DE:\RECENT
  175.  This would cause AUTOSCAN to run in Quiet Mode (/Q), rescan all files (/R),
  176.  copy all .BAD files to C:\BADFILES (/B), supress the ending screen (/I), 
  177.  and examine the directory E:\RECENT (/D). The Command line is limited to 
  178.  80 characters so keep those paths small!!
  179.  
  180.  AUTOSCAN.CFG
  181.  ────────────
  182.  Included in the Archive is a file called AutoScan.Cfg. In this file you can
  183.  set certain default settings for AutoScan. Edit this file with an ASCII editor
  184.  to suit your liking. If you wish to use different config files you can specify
  185.  the name on the command line with the /K option.
  186.  AUTOSCAN /KC:\AUTOCFG.CFG would cause AutoScan to use the Autocfg.Cfg file
  187.  in the root directory of drive C:. This option MUST BE THE FIRST OPTION 
  188.  otherwise it will be ignored. You can add further options on the command line
  189.  after the /k option, IE: AutoScan /KC:\AUTOCFG.CFG /R /I .
  190.  To set the command line parameters for SCAN.EXE use the /P option within the
  191.  current config file.  As many parameters can be used as long it is limited to
  192.  100 characters.  /P /A /FR will cause Scan to scan all files and display all
  193.  messages in french.
  194.  
  195.  HELP and SCAN.EXE
  196.  ─────────────────
  197.  For help on the fly type AUTOSCAN ? and it will display some information
  198.  about itself.
  199.  
  200.  In order for AutoScan to detect all known virus's you must keep your
  201.  version of SCAN.EXE as current as possible. AutoScan is only as good
  202.  as the Scanner it uses. SCAN.EXE can be found on most good bulletin 
  203.  boards in your area. 
  204.  
  205.  *.BAD
  206.  ─────
  207.  If AutoScan comes across a bad archive or a virus that file will be
  208.  renamed to "filename".BAD and make a note in the log indicating which
  209.  file is SUSPECT of being bad. If a file is flagged as being bad you 
  210.  might want to examine it manually to see why. If the /B option was used
  211.  that file would be copied to the specified directory.
  212.  
  213.  NEWLIST.TXT
  214.  ───────────
  215.  As AutoScan runs it generates a file called NEWLIST.TXT. (Only if the /L
  216.  option is enabled) In this file it will place the names of any new files
  217.  that it has just processed. If you have an archive commenter that can use
  218.  this file then please do. I am in the process of writing one for ZIP files 
  219.  and it should be released soon.
  220.  
  221.  F10 - ABORT 
  222.  ───────────
  223.  While AutoScan is running pressing  F10 will cause AutoScan to abort the
  224.  current session.  AutoScan will only stop once the current file has been
  225.  finished and the work files have all been deleted. AutoScan will report on
  226.  the current status of it's operation and further runnings of AutoScan will
  227.  just pick up where it left off.  AutoScan will exit on an ERRORLEVEL of 0
  228.  in this case.
  229.  
  230.  AUTOSCAN.DAT
  231.  ────────────
  232.  Once AutoScan has completed its operations it will update a file called
  233.  AUTOSCAN.DAT, this file contains a list of files that have already been
  234.  scanned.  For sysops, this makes it possible to run AutoScan after users
  235.  have logged off the BBS, and if any new files were uploaded, they get
  236.  scanned right away and removed from circulation if needed. 
  237.  
  238.  The Naughty Bits
  239.  ────────────────
  240.  Each time AutoScan starts up it checks it's own size and CRC, and if it
  241.  has changed, it will terminate with a nasty message. AutoScan will also
  242.  check disk space each time it starts up. If the amount of disk space left
  243.  is less than 150% of the archive size AutoScan will exit on a ErrorLevel 1.
  244.  
  245.  Errorlevels
  246.  ───────────
  247.  AutoScan will exit on one of 5 DOS ErrorLevels..
  248.  
  249.            ErrorLevel 0 - New Files found and processed.
  250.            ErrorLevel 1 - SCAN.EXE missing / No Disk Space /
  251.                           AUTOSCAN.EXE infected / File Error.
  252.            Errorlevel 2 - No New Files. 
  253.            ErrorLevel 3 - Bad Archive, Renamed to .BAD.
  254.            ErrorLevel 4 - VIRUS, Renamed to .BAD.
  255.  
  256.  What In?
  257.  ────────
  258.  AUTOSCAN is written in Turbo Pascal 6.0 and some routines are from
  259.  the TechnoJock Turbo Toolkit V5.02 (excellent package if your a TP 4/5/6
  260.  programmer).
  261.  
  262.  AUTOSCAN uses many "outside" programs, without which AUTOSCAN would not
  263.  function. Please show your appreciation and register these fine programs.
  264.  
  265.  What If?
  266.  ────────
  267.  If AUTOSCAN does report that SCAN.EXE found a virus, what do I do?  Either
  268.  contact McAffee Associates, and they can guide you through getting rid of
  269.  the virus, or you can run SCAN.EXE manually with a /D on the command line.
  270.  SCAN /D will delete any file found with a virus.  Also Mace Utilities 1990
  271.  and CLEANPxx.ZIP will get rid of any viruses after they are detected.
  272.  
  273.  The key to virus protection is that ugly word "BACKUP"!  Always backup any
  274.  critical files that you may have.  
  275.  
  276.  ***************************************************************************
  277.  * If AutoScan detects a Virus on your system PLEASE PLEASE let us know by *
  278.  * either mailing me a quick note or netmailing me.  We would like to keep *
  279.  * track of how well AutoScan is performing.                               *
  280.  ***************************************************************************
  281.  
  282.  The Best
  283.  ────────
  284.  This program would not be possible without the creation of these fine
  285.  programs:
  286.  
  287.  PKZip / PKPak  -  PKWare / Phil Katz             -  PKZxxx.EXE
  288.  
  289.  PAK            -  NoGate Programming             -  PAKxxx.EXE
  290.  
  291.  ARC,XARC       -  System Enhancement Associates  -  N/A
  292.  
  293.  Lharc (LZH)    -  Yoshi                          -  LHxxx.EXE
  294.  
  295.  Turbo Pascal   -  Borland Corporation            -  N/A
  296.  5.5 / 6.0
  297.  
  298.  TechnoJock     -  TechonoJock Software           -  TTT502.ZIP
  299.  5.02 
  300.  
  301.  SCAN           -  McAffee Associates             -  SCANVxx.ZIP
  302.  
  303.  
  304.  The Rest  
  305.  ────────
  306.  AutoScan is distributed under the Shareware concept, and you are given a
  307.  LIMITED contract to use AutoScan.   You may use it free of charge for a
  308.  period of THIRTY (30) DAYS, and then you must register it. There is a
  309.  registration fee of $15.00 US dollars ($20.00 Canadian). See REGISTER.NOW
  310.  for more details. A lot of work has gone into creating this program, and
  311.  if you would like to see it continue, please contribute.  
  312.  
  313.  The author shall not be held responsible for any hardware or software damage
  314.  associated.  You are using this program at your own risk.
  315.  
  316.  You are NOT allowed to distribute this program for any money, but are able
  317.  to distribute it for fee but only for the amount of the disk and/or the 
  318.  price of postage.
  319.  
  320.  Final Word
  321.  ──────────
  322.  Thank you to everyone who helped out with the nasty task of debugging
  323.  this thing...THANKS! THANKS! THANKS!...
  324.  
  325.  Thanks to Eric Boehm for putting the seed to this program in my head and
  326.  testing many different versions in the same day! 
  327.  Thanks to all those in the Pascal Echo who help me with some of the
  328.  stranger points in this program. You can always find me in there! 
  329.  Thanks to Josh for help with these docs..
  330.  
  331.  My Beta testers:
  332.   Josh Linder, Rich Lowenburg, Bob Moravsik (The infamous!!!) and Eric
  333.   Boehm and all the others who moaned about the Runtime Error 5 and 6
  334.   of Version 2.0!.
  335.   
  336.  Where to find me
  337.  ────────────────
  338.  Somewhere in the FidoNet Pascal Echo, Virus Echo and the Virus Info Echo.
  339.  or at:
  340.  
  341.                    /\/\ountainTop Technologies
  342.                    Suite 176
  343.                    420 Route 206 North
  344.                    Bedminster, NJ 07921 USA
  345.                    ATTN:Nick Tucker
  346.  
  347.  If you have access to FidoNet Mail I can be reached at 1:269/583.1
  348.  
  349.  Thanks for using AutoScan and /\/\ountainTop Technologies   !!
  350.  
  351.  
  352.  
  353.